home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / XmManager.z / XmManager
Encoding:
Text File  |  1998-10-20  |  44.6 KB  |  661 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr - The Manager widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           Manager is a widget class used as a supporting superclass
  20.           for other widget classes.  It supports the visual resources,
  21.           graphics contexts, and traversal resources necessary for the
  22.           graphics and traversal mechanisms.
  23.  
  24.         CCCCllllaaaasssssssseeeessss
  25.           Manager inherits behavior and resources from CCCCoooorrrreeee,
  26.           CCCCoooommmmppppoooossssiiiitttteeee, and CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt classes.
  27.  
  28.           The class pointer is xxxxmmmmMMMMaaaannnnaaaaggggeeeerrrrWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  29.  
  30.           The class name is XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr.
  31.  
  32.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  33.           The following table defines a set of widget resources used
  34.           by the programmer to specify data.  The programmer can also
  35.           set the resource values for the inherited classes to set
  36.           attributes for this widget.  To reference a resource by name
  37.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  38.           prefix and use the remaining letters.  To specify one of the
  39.           defined values for a resource in a .Xdefaults file, remove
  40.           the XXXXmmmm prefix and use the remaining letters (in either
  41.           lowercase or uppercase, but include any underscores between
  42.           words).  The codes in the access column indicate if the
  43.           given resource can be set at creation time (C), set by using
  44.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  45.           not applicable (N/A).
  46.  
  47.                                           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  48.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  49.      _________________________________________________________________________________________________
  50.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
  51.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  52.      XmNforeground           XmCForeground           Pixel               dynamic                CSG
  53.      XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
  54.      XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
  55.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
  56.      XmNinitialFocus         XmCInitialFocus         Widget              NULL                   CSG
  57.      XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      XmNshadowThickness      XmCShadowThickness      Dimension           0                      CSG
  75.      XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
  76.      XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
  77.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
  78.      XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
  79.      XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
  80.      XmNuserData             XmCUserData             XtPointer           NULL                   CSG
  81.  
  82.  
  83.           XXXXmmmmNNNNbbbboooottttttttoooommmmSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr
  84.                     Specifies the color to use to draw the bottom and
  85.                     right sides of the border shadow.  This color is
  86.                     used if the XXXXmmmmNNNNbbbboooottttttttoooommmmSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp resource is
  87.                     NULL.
  88.  
  89.           XXXXmmmmNNNNbbbboooottttttttoooommmmSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp
  90.                     Specifies the pixmap to use to draw the bottom and
  91.                     right sides of the border shadow.
  92.  
  93.           XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd
  94.                     Specifies the foreground drawing color used by
  95.                     manager widgets.
  96.  
  97.           XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk
  98.                     Specifies the list of callbacks that are called
  99.                     when the help key sequence is pressed.  The reason
  100.                     sent by this callback is XXXXmmmmCCCCRRRR____HHHHEEEELLLLPPPP.
  101.  
  102.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttCCCCoooolllloooorrrr
  103.                     Specifies the color of the highlighting rectangle.
  104.                     This color is used if the highlight pixmap
  105.                     resource is XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP.
  106.  
  107.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttPPPPiiiixxxxmmmmaaaapppp
  108.                     Specifies the pixmap used to draw the highlighting
  109.                     rectangle.
  110.  
  111.           XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss
  112.                     Specifies the ID of a widget descendant of the
  113.                     manager.  The widget must meet these conditions:
  114.  
  115.  
  116.                       +o  The widget must be either a tab group or a
  117.                          non-tab-group widget that can receive
  118.                          keyboard focus.  For the definition of a tab
  119.                          group, see the description of the Manager,
  120.                          Primitive, and Gadget XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee
  121.                          resources.  In general a widget can receive
  122.                          keyboard focus when it is a primitive, a
  123.                          gadget, or a manager (such as a DrawingArea
  124.                          with no traversable children) that acts as a
  125.                          primitive.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                       +o  The widget must not be a descendant of a tab
  141.                          group that is itself a descendant of the
  142.                          manager.  That is, the widget cannot be
  143.                          contained within a tab group that is nested
  144.                          inside the manager.
  145.  
  146.                       +o  The widget and its ancestors must have a
  147.                          value of True for their XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn
  148.                          resources.
  149.  
  150.  
  151.                     If the widget does not meet these conditions,
  152.                     XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is treated as if the value were
  153.                     NULL.
  154.  
  155.                     This resource is meaningful only when the nearest
  156.                     shell ancestor's XXXXmmmmNNNNkkkkeeeeyyyybbbbooooaaaarrrrddddFFFFooooccccuuuussssPPPPoooolllliiiiccccyyyy is
  157.                     XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT.  It is used to determine which widget
  158.                     receives focus in these situations:
  159.  
  160.  
  161.                       +o  When the manager is the child of a shell and
  162.                          the shell hierarchy receives focus for the
  163.                          first time
  164.  
  165.                       +o  When focus is inside the shell hierarchy, the
  166.                          manager is a composite tab group, and the
  167.                          user traverses to the manager via the
  168.                          keyboard
  169.  
  170.  
  171.                     Focus is then determined as follows:
  172.  
  173.  
  174.                       +o  If XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is a traversable non-tab-
  175.                          group widget, that widget receives focus.
  176.  
  177.                       +o  If XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is a traversable tab
  178.                          group, that tab group receives focus.  If
  179.                          that tab group is a composite with descendant
  180.                          tab groups or traversable non-tab-group
  181.                          widgets, these procedures are used
  182.                          recursively to assign focus to a descendant
  183.                          of that tab group.
  184.  
  185.                       +o  If XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is NULL, the first
  186.                          traversable non-tab-group widget that is not
  187.                          contained within a nested tab group receives
  188.                          focus.
  189.  
  190.                       +o  If XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is NULL and no traversable
  191.                          non-tab-group widget exists, the first
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                          traversable tab group that is not contained
  207.                          within a nested tab group receives focus.  If
  208.                          that tab group is a composite with descendant
  209.                          tab groups or traversable non-tab-group
  210.                          widgets, these procedures are used
  211.                          recursively to assign focus to a descendant
  212.                          of that tab group.
  213.  
  214.  
  215.                     If a shell hierarchy regains focus after losing
  216.                     it, focus returns to the widget that had the focus
  217.                     at the time it left the hierarchy.
  218.  
  219.                     The use of XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is undefined if the
  220.                     manager is a MenuBar, PulldownMenu, PopupMenu, or
  221.                     OptionMenu.
  222.  
  223.           XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee
  224.                     Determines whether the widget is a tab group.
  225.  
  226.  
  227.                       +o  XXXXmmmmNNNNOOOONNNNEEEE indicates that the widget is not a tab
  228.                          group.
  229.  
  230.                       +o  XXXXmmmmTTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP indicates that the widget is a
  231.                          tab group, unless another widget in the
  232.                          hierarchy has an XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee of
  233.                          XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP.
  234.  
  235.                       +o  XXXXmmmmSSSSTTTTIIIICCCCKKKKYYYY____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP indicates that the widget
  236.                          is a tab group, even if another widget in the
  237.                          hierarchy has an XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee of
  238.                          XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP.
  239.  
  240.                       +o  XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP indicates that the
  241.                          widget is a tab group and that widgets in the
  242.                          hierarchy whose XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is
  243.                          XXXXmmmmTTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP are not tab groups.
  244.  
  245.                          When a parent widget has an XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee
  246.                          of XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP, traversal of non-
  247.                          tab-group widgets within the group is based
  248.                          on the order of those widgets in their
  249.                          parent's XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn list.
  250.  
  251.                          When any widget in a hierarchy has an
  252.                          XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee of XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP,
  253.                          traversal of tab groups in the hierarchy
  254.                          proceeds to widgets in the order in which
  255.                          their XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee resources were
  256.                          specified as XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP or
  257.                          XXXXmmmmSSSSTTTTIIIICCCCKKKKYYYY____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP, whether by creating the
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                          widgets with that value, by calling
  273.                          XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss, or by calling XXXXmmmmAAAAddddddddTTTTaaaabbbbGGGGrrrroooouuuupppp.
  274.  
  275.  
  276.           XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss
  277.                     Specifies the thickness of the drawn border
  278.                     shadow.  XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd and its descendants set
  279.                     this value dynamically.  If the widget is a top
  280.                     level window, this value is set to 1.  If it is
  281.                     not a top level window, this value is set to 0.
  282.  
  283.           XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  284.                     Specifies the initial direction to draw strings.
  285.                     The values are XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____LLLL____TTTTOOOO____RRRR and
  286.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____RRRR____TTTTOOOO____LLLL.  The value of this
  287.                     resource is determined at creation time.  If the
  288.                     widget's parent is a manager, this value is
  289.                     inherited from the widget's parent, otherwise it
  290.                     is set to XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____LLLL____TTTTOOOO____RRRR.
  291.  
  292.           XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr
  293.                     Specifies the color to use to draw the top and
  294.                     left sides of the border shadow.  This color is
  295.                     used if the XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp resource is NULL.
  296.  
  297.           XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp
  298.                     Specifies the pixmap to use to draw the top and
  299.                     left sides of the border shadow.
  300.  
  301.           XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn
  302.                     Specifies whether traversal is activated for this
  303.                     widget.
  304.  
  305.           XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee
  306.                     Provides the basic support for resolution
  307.                     independence.  It defines the type of units a
  308.                     widget uses with sizing and positioning resources.
  309.                     If the widget's parent is a subclass of XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr
  310.                     and if the XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee resource is not explicitly
  311.                     set, it defaults to the unit type of the parent
  312.                     widget.  If the widget's parent is not a subclass
  313.                     of XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, the resource has a default unit type
  314.                     of XXXXmmmmPPPPIIIIXXXXEEEELLLLSSSS.
  315.  
  316.                     XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee can have the following values:
  317.  
  318.  
  319.                       +o  XXXXmmmmPPPPIIIIXXXXEEEELLLLSSSS-all values provided to the widget
  320.                          are treated as normal pixel values.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                       +o  XXXXmmmm111100000000TTTTHHHH____MMMMIIIILLLLLLLLIIIIMMMMEEEETTTTEEEERRRRSSSS-all values provided to
  339.                          the widget are treated as 1/100 millimeter.
  340.  
  341.                       +o  XXXXmmmm1111000000000000TTTTHHHH____IIIINNNNCCCCHHHHEEEESSSS-all values provided to the
  342.                          widget are treated as 1/1000 inch.
  343.  
  344.                       +o  XXXXmmmm111100000000TTTTHHHH____PPPPOOOOIIIINNNNTTTTSSSS-all values provided to the
  345.                          widget are treated as 1/100 point.  A point
  346.                          is a unit used in text processing
  347.                          applications and is defined as 1/72 inch.
  348.  
  349.                       +o  XXXXmmmm111100000000TTTTHHHH____FFFFOOOONNNNTTTT____UUUUNNNNIIIITTTTSSSS-all values provided to the
  350.                          widget are treated as 1/100 of a font unit.
  351.                          A font unit has horizontal and vertical
  352.                          components.  These are the values of the
  353.                          XmScreen resources XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt and
  354.                          XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt.
  355.  
  356.  
  357.           XXXXmmmmNNNNuuuusssseeeerrrrDDDDaaaattttaaaa
  358.                     Allows the application to attach any necessary
  359.                     specific data to the widget.  This is an
  360.                     internally unused resource.
  361.  
  362.  
  363.         DDDDyyyynnnnaaaammmmiiiicccc CCCCoooolllloooorrrr DDDDeeeeffffaaaauuuullllttttssss
  364.           The foreground, background, top shadow, bottom shadow, and
  365.           highlight color resources are dynamically defaulted.  If no
  366.           color data is specified, the colors are automatically
  367.           generated.  On a single-plane system, a black and white
  368.           color scheme is generated.  Otherwise, four colors are
  369.           generated, which display the correct shading for the 3-D
  370.           visuals.  If the background is the only color specified for
  371.           a widget, the top shadow and bottom shadow colors are
  372.           generated to give the 3-D appearance.  Foreground and
  373.           highlight colors are generated to provide sufficient
  374.           contrast with the background color.
  375.  
  376.           Colors are generated only at creation.  Resetting the
  377.           background through XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss does not regenerate the other
  378.           colors.  XXXXmmmmCCCChhhhaaaannnnggggeeeeCCCCoooolllloooorrrr can be used to recalculate all
  379.           associated colors based on a new background color.
  380.  
  381.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  382.           Manager inherits the following resources from the named
  383.           superclasses.  For a complete description of each resource,
  384.           refer to the man page for that superclass.
  385.  
  386.                              CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  387.      NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  401.  
  402.  
  403.  
  404.      ______________________________________________________________________
  405.      XmNchildren         XmCReadOnly         WidgetList    NULL      G
  406.      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  407.      XmNnumChildren      XmCReadOnly         Cardinal      0         G
  408.  
  409.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  410.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  411.      ______________________________________________________________________________________________________________
  412.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  413.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  414.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  415.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  416.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  417.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  418.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  419.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  420.      XmNdepth                        XmCDepth                        int              dynamic                CG
  421.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  422.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  423.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  424.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  425.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  426.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  427.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  428.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  429.      XmNx                            XmCPosition                     Position         0                      CSG
  430.      XmNy                            XmCPosition                     Position         0                      CSG
  431.  
  432.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  433.           A pointer to the following structure is passed to each
  434.           callback:
  435.  
  436.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  437.           {{{{
  438.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  439.             XXXXEEEEvvvveeeennnntttt       * _e_v_e_n_t;;;;
  440.           }}}} XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  441.  
  442.  
  443.           _r_e_a_s_o_n Indicates why the callback was invoked.  For this
  444.                  callback, _r_e_a_s_o_n is set to XXXXmmmmCCCCRRRR____HHHHEEEELLLLPPPP.
  445.  
  446.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.
  447.  
  448.  
  449.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  450.           The following set of translations are used by Manager
  451.           widgets that have Gadget children.  Since Gadgets cannot
  452.           have translations associated with them, it is the
  453.           responsibility of the Manager widget to intercept the events
  454.           of interest and pass them to any Gadget child with focus.
  455.           These events are ignored if no Gadget child has the focus.
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  467.  
  468.  
  469.  
  470.           These translations may not directly correspond to a
  471.           translation table.
  472.  
  473.           BBBBAAAAnnnnyyyy MMMMoooottttiiiioooonnnn::::   MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttBBBBuuuuttttttttoooonnnnMMMMoooottttiiiioooonnnn(((())))
  474.           BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss:::: MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttAAAArrrrmmmm(((())))
  475.           BBBBSSSSeeeelllleeeecccctttt CCCClllliiiicccckkkk:::: MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttAAAAccccttttiiiivvvvaaaatttteeee(((())))
  476.           BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee::::MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttAAAAccccttttiiiivvvvaaaatttteeee(((())))
  477.           BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss 2222++++::::MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttMMMMuuuullllttttiiiiAAAArrrrmmmm(((())))
  478.           BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee 2222++++::::MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttMMMMuuuullllttttiiiiAAAAccccttttiiiivvvvaaaatttteeee(((())))
  479.           BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::   MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttDDDDrrrraaaagggg(((())))
  480.  
  481.           KKKKSSSSeeeelllleeeecccctttt::::       MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttSSSSeeeelllleeeecccctttt(((())))
  482.           KKKKAAAAccccttttiiiivvvvaaaatttteeee::::     MMMMaaaannnnaaaaggggeeeerrrrPPPPaaaarrrreeeennnnttttAAAAccccttttiiiivvvvaaaatttteeee(((())))
  483.  
  484.           KKKKCCCCaaaannnncccceeeellll::::       MMMMaaaannnnaaaaggggeeeerrrrPPPPaaaarrrreeeennnnttttCCCCaaaannnncccceeeellll(((())))
  485.  
  486.           KKKKPPPPrrrreeeevvvvFFFFiiiieeeelllldddd::::    MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttPPPPrrrreeeevvvvTTTTaaaabbbbGGGGrrrroooouuuupppp(((())))
  487.           KKKKNNNNeeeexxxxttttFFFFiiiieeeelllldddd::::    MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttNNNNeeeexxxxttttTTTTaaaabbbbGGGGrrrroooouuuupppp(((())))
  488.  
  489.           KKKKUUUUpppp::::           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeUUUUpppp(((())))
  490.           KKKKDDDDoooowwwwnnnn::::         MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeDDDDoooowwwwnnnn(((())))
  491.           KKKKLLLLeeeefffftttt::::         MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeLLLLeeeefffftttt(((())))
  492.           KKKKRRRRiiiigggghhhhtttt::::        MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeRRRRiiiigggghhhhtttt(((())))
  493.  
  494.           KKKKBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee::::    MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeHHHHoooommmmeeee(((())))
  495.  
  496.           KKKKHHHHeeeellllpppp::::         MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttHHHHeeeellllpppp(((())))
  497.  
  498.           KKKKAAAAnnnnyyyy::::          MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttKKKKeeeeyyyyIIIInnnnppppuuuutttt(((())))
  499.  
  500.  
  501.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  502.           The XmManager action routines are described below:
  503.  
  504.  
  505.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttAAAAccccttttiiiivvvvaaaatttteeee(((()))):
  506.                     Causes the current gadget to be activated.
  507.  
  508.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttAAAArrrrmmmm(((()))):
  509.                     Causes the current gadget to be armed.
  510.  
  511.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttBBBBuuuuttttttttoooonnnnMMMMoooottttiiiioooonnnn(((()))):
  512.                     Causes the current gadget to process a mouse
  513.                     motion event.
  514.  
  515.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttDDDDrrrraaaagggg(((()))):
  516.                     Drags the contents of a gadget label, identified
  517.                     by pressing BBBBDDDDrrrraaaagggg.  This action creates a
  518.                     DragContext object whose XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss resource
  519.                     is set to "COMPOUND_TEXT" for a label type of
  520.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG; otherwise, "PIXMAP" if the label type is
  521.                     XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP.  This action is undefined for gadgets
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  533.  
  534.  
  535.  
  536.                     used in a menu system.
  537.  
  538.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttHHHHeeeellllpppp(((()))):
  539.                     Calls the callbacks for the current gadget's
  540.                     XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any exist.  If there are no
  541.                     help callbacks for this widget, this action calls
  542.                     the help callbacks for the nearest ancestor that
  543.                     has them.
  544.  
  545.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttKKKKeeeeyyyyIIIInnnnppppuuuutttt(((()))):
  546.                     Causes the current gadget to process a keyboard
  547.                     event.
  548.  
  549.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttMMMMuuuullllttttiiiiAAAAccccttttiiiivvvvaaaatttteeee(((()))):
  550.                     Causes the current gadget to process a multiple
  551.                     mouse click.
  552.  
  553.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttMMMMuuuullllttttiiiiAAAArrrrmmmm(((()))):
  554.                     Causes the current gadget to process a multiple
  555.                     mouse button press.
  556.  
  557.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttNNNNeeeexxxxttttTTTTaaaabbbbGGGGrrrroooouuuupppp(((()))):
  558.                     Traverses to the first item in the next tab group.
  559.                     If the current tab group is the last entry in the
  560.                     tab group list, it wraps to the beginning of the
  561.                     tab group list.
  562.  
  563.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttPPPPrrrreeeevvvvTTTTaaaabbbbGGGGrrrroooouuuupppp(((()))):
  564.                     Traverses to the first item in the previous tab
  565.                     group.  If the beginning of the tab group list is
  566.                     reached, it wraps to the end of the tab group
  567.                     list.
  568.  
  569.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttSSSSeeeelllleeeecccctttt(((()))):
  570.                     Causes the current gadget to be armed and
  571.                     activated.
  572.  
  573.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeDDDDoooowwwwnnnn(((()))):
  574.                     Traverses to the next item below the current
  575.                     gadget in the current tab group, wrapping if
  576.                     necessary.
  577.  
  578.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeHHHHoooommmmeeee(((()))):
  579.                     Traverses to the first widget or gadget in the
  580.                     current tab group.
  581.  
  582.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeLLLLeeeefffftttt(((()))):
  583.                     Traverses to the next item to the left of the
  584.                     current gadget in the current tab group, wrapping
  585.                     if necessary.
  586.  
  587.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeNNNNeeeexxxxtttt(((()))):
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 4/30/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX))))
  599.  
  600.  
  601.  
  602.                     Traverses to the next item in the current tab
  603.                     group, wrapping if necessary.
  604.  
  605.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeePPPPrrrreeeevvvv(((()))):
  606.                     Traverses to the previous item in the current tab
  607.                     group, wrapping if necessary.
  608.  
  609.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeRRRRiiiigggghhhhtttt(((()))):
  610.                     Traverses to the next item to the right of the
  611.                     current gadget in the current tab group, wrapping
  612.                     if necessary.
  613.  
  614.           MMMMaaaannnnaaaaggggeeeerrrrGGGGaaaaddddggggeeeettttTTTTrrrraaaavvvveeeerrrrsssseeeeUUUUpppp(((()))):
  615.                     Traverses to the next item above the current
  616.                     gadget in the current tab group, wrapping if
  617.                     necessary.
  618.  
  619.           MMMMaaaannnnaaaaggggeeeerrrrPPPPaaaarrrreeeennnnttttAAAAccccttttiiiivvvvaaaatttteeee(((()))):
  620.                     If the parent is a manager, passes the KKKKAAAAccccttttiiiivvvvaaaatttteeee
  621.                     event received by the current widget/gadget to its
  622.                     parent.
  623.  
  624.           MMMMaaaannnnaaaaggggeeeerrrrPPPPaaaarrrreeeennnnttttCCCCaaaannnncccceeeellll(((()))):
  625.                     If the parent is a manager, passes the KKKKCCCCaaaannnncccceeeellll
  626.                     event received by the current widget/gadget to its
  627.                     parent.
  628.  
  629.  
  630.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  631.           This widget has the additional behavior described below:
  632.  
  633.  
  634.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  635.                     If the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT
  636.                     and the event occurs in a gadget, causes the
  637.                     gadget to be highlighted and to take the focus.
  638.  
  639.           <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
  640.                     If the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT
  641.                     and the event occurs in a gadget, causes the
  642.                     gadget to be unhighlighted and to lose the focus.
  643.  
  644.  
  645.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  646.           The bindings for virtual keys are vendor specific.  For
  647.           information about bindings for virtual buttons and keys, see
  648.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  649.  
  650.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  651.           CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX)))), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmCCCChhhhaaaannnnggggeeeeCCCCoooolllloooorrrr((((3333XXXX)))),
  652.           XXXXmmmmGGGGaaaaddddggggeeeetttt((((3333XXXX)))), and XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))).
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 4/30/98)
  658.  
  659.  
  660.  
  661.